home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / ppagesd.z / ppagesd
Encoding:
Text File  |  2001-04-17  |  6.7 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ppppppppaaaaggggeeeessssdddd((((1111MMMM))))                                                        ppppppppaaaaggggeeeessssdddd((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppagesd -  PeoplePages database server
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////eeeettttcccc////ppppppppaaaaggggeeeessssdddd [[[[----tttt _t_t_l ]]]] _d_i_r_p_a_t_h _b_o_o_k_n_a_m_e
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _p_p_a_g_e_s_d is the dynamic networked _p_e_o_p_l_e_p_a_g_e_s(1) database server.  It has
  16.      two functions: it provides the location of the NFS-mountable PeoplePages
  17.      database directory to _p_e_o_p_l_e_p_a_g_e_s, and it listens for entry data from
  18.      InPersonTM and stores the received data into the database.  The
  19.      _p_e_o_p_l_e_p_a_g_e_s application uses NFS and the _a_u_t_o_m_o_u_n_t(1M) to access the
  20.      database.
  21.  
  22.      _p_p_a_g_e_s_d is started at system initialization if the configuration flag
  23.      _p_p_a_g_e_s_d is set ``on'' with _c_h_k_c_o_n_f_i_g(1M).  The 2 required site-dependent
  24.      arguments to _p_p_a_g_e_s_d belong in the file /_e_t_c/_c_o_n_f_i_g/_p_p_a_g_e_s_d._o_p_t_i_o_n_s.
  25.  
  26.      The _d_i_r_p_a_t_h argument is the absolute pathname of a directory to hold the
  27.      database files.  The _b_o_o_k_n_a_m_e argument specifies a "logical" name for the
  28.      database.  It also determines which entry data packets should be
  29.      examined.  To store entries from InPerson users, it should be "InPerson".
  30.  
  31.      To start _p_p_a_g_e_s_d servers for several books, put the dirpath/bookname
  32.      pairs on separate lines in the ppagesd.options file.
  33.  
  34.      For each _b_o_o_k_n_a_m_e, only one machine on a local area network should be
  35.      configured as the server.
  36.  
  37.      The optional _t_t_l argument specifies the _t_i_m_e-_t_o-_l_i_v_e for the multicast
  38.      packets sent out in answer to queries from _P_e_o_p_l_e_P_a_g_e_s clients.  This is
  39.      the maximum number of gateways through which the packets will be
  40.      forwarded.
  41.  
  42. DDDDEEEETTTTAAAAIIIILLLLSSSS
  43.      When _p_e_o_p_l_e_p_a_g_e_s starts up, it sends out a query to find the location of
  44.      PeoplePages databases.  _p_p_a_g_e_s_d replies with the _b_o_o_k_n_a_m_e and _d_i_r_p_a_t_h
  45.      information: the directory name is prepended with "/hosts/<hostname>" so
  46.      that the PeoplePages can use _a_u_t_o_m_o_u_n_t(1M) to access the directory via
  47.      NFS.  _p_p_a_g_e_s_d also listens for multicast packets from _i_n_p_e_r_s_o_n(1) and
  48.      stores them in the database if no entry exists.
  49.  
  50.      Each entry in the database is a file containing name:value pairs. Each
  51.      line can be up to 1024 characters including the trailing nul character.
  52.  
  53.      If you create an entry for a user in the public database, and you want to
  54.      allow them to modify it later, be sure to use _c_h_o_w_n(1M) to change the
  55.      file ownership to the user.  If you don't want them to modify, then don't
  56.      change the ownership.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppppppaaaaggggeeeessssdddd((((1111MMMM))))                                                        ppppppppaaaaggggeeeessssdddd((((1111MMMM))))
  71.  
  72.  
  73.  
  74. CCCCUUUUSSSSTTTTOOOOMMMMIIIIZZZZIIIINNNNGGGG TTTTHHHHEEEE DDDDAAAATTTTAAAABBBBAAAASSSSEEEE
  75.      You can customize both the name and the cover of your book as shown on
  76.      the book-selection button at the top of _p_e_o_p_l_e_p_a_g_e_s's main window.  The
  77.      name goes into the file ._l_a_b_e_l in the database directory.  Two cover
  78.      images in either .xpm (X Pixmap) or .rgb (standard SGI) format are
  79.      required.  One is displayed when the book is closed, the other when it is
  80.      opened for reading.  They go in the files ._c_o_v_e_r-_c_l_o_s_e_d and ._c_o_v_e_r-_o_p_e_n
  81.      in the database directory.  The images should be 44 by 32 pixels.  Xpm
  82.      format is recommended because it allows you to tag the predominant
  83.      background color of the pixmap.  Having this information allows _I_n_P_a_g_e_s
  84.      to do make a better visual presentation of your images.  To tag the
  85.      background add " s background" at the end of the line specifying the
  86.      predominant background color.  For example the line
  87.  
  88.            % c #848484
  89.  
  90.      becomes
  91.  
  92.            % c #848484 s background
  93.  
  94.  
  95. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  96.      To store InPerson entries in /var/ppages/inperson,
  97.      /_e_t_c/_c_o_n_f_i_g/_p_p_a_g_e_s_d._o_p_t_i_o_n_s should contain
  98.  
  99.           /var/ppages/inperson InPerson
  100.  
  101.  
  102.      To start servers for InPerson entries as well a list of conference room
  103.      entries, put the following lines in ppagesd.options:
  104.  
  105.           /var/ppages/inperson InPerson
  106.           /var/ppages/conf     Conference
  107.  
  108.  
  109. FFFFIIIILLLLEEEESSSS
  110.      /etc/config/ppagesd.options
  111.  
  112. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  113.      peoplepages(1), inperson(1)
  114.      PeoplePages Administrator's Guide
  115.  
  116. NNNNOOOOTTTTEEEE
  117.      The NFS optional software must be installed and configured to export the
  118.      specified database directory(s).  Write access to the directory(s) is
  119.      needed if users are permitted to change their entries using
  120.      _p_e_o_p_l_e_p_a_g_e_s(1).  Use the _c_h_m_o_d(1) command to change the permissions and
  121.      set the sticky bit restrict the right to delete records to the owner of
  122.      the record:
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ppppppppaaaaggggeeeessssdddd((((1111MMMM))))                                                        ppppppppaaaaggggeeeessssdddd((((1111MMMM))))
  137.  
  138.  
  139.  
  140.           chmod 1777 _d_i_r_e_c_t_o_r_y
  141.  
  142.  
  143.      If users are on different networks, the network administrator should
  144.      configure multicast routers between the networks for _p_p_a_g_e_s_d to receive
  145.      location requests and entry data from users.  See _m_r_o_u_t_e_d(1M) and the
  146.      InPerson Setup and Admin Guide for details.
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.